home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 36 / Amiga Format CD36 (1999-01-22)(Future Publishing)(GB)[!][issue 1999-02].iso / -seriously_amiga- / wb / amigaeye_vxx.6 / amigaeye.doc < prev    next >
Text File  |  1998-12-07  |  18KB  |  321 lines
  1.                                              _   _
  2.                                             / \ / \
  3.                                             \#/ \#/
  4.            _              _                    _      _             _
  5.           /(\  Version:  /(\     _            /(\    /(\           /(\
  6.          /  \    37.6   /  \    /(\          /  \   /  \          /  \
  7.         /    \   39.6  /    \  /  \         /    \ /    \___     /    \
  8.        /      \       /      \/    \       /     //     ___ \   /      \
  9.       /        \     /              \     /     //     /\__\ \ /        \
  10.      /          \   /                \   /     //     / /   )//          \
  11.     /     /\     \ /     /\    /\     \ /     //     / /    \/     /\     \
  12.    /     /__\    //     / /\  / /\    //     //     / /______\    /__\     \
  13.   /     ____    //     / /  \/ / /   //     //     / / _     \\    ____     \
  14.  /     /\__/   //     / /    \/ /   //     / \    ( /\( \    /\\   \___\     \
  15.  \    ( / (___/ \    ( /       (___/ \    ( / \    V  \\/   / / \___)\  )    /\
  16.   \    V   \__\/ \    V         \__\/ \    V   \    \__7   / /   \__\/ /    / /
  17.    \___/\         \___/\               \___/\   \_________/ /          \___/ /
  18.     \__\/  sMail:  \__\/     eMail:     \__\/    \________\/            \__\/
  19.                                                            _______  ___ _____
  20.   Christian Krapp      Christian.Krapp@Augsburg.BayNet.De / __//\ \/ /// __//
  21.   Hagenmähderstr.9                                       / _//   \  /// _//
  22. D-86391 Stadtbergen                                     / //__   / /// //__
  23.   (GERMANY)                                             \___//  /_// \___//
  24.                                                © 1995-1999 by Christian Krapp
  25.                                                     Released as SHAREWARE
  26.  http://www.augsburg.baynet.de/homepages/ba044406/
  27.  
  28.              An AugustA team Release!
  29. --------------------------------------------------------------------------------
  30.  
  31. Copyright:
  32.   This program and all accompanying files (program-icon) are copyrighted 1995-99
  33. by Christian 'cr8y' Krapp! You can  copy these  files to your friends as long as
  34. the files are unchanged. It is not allowed to demand a fee higher as media costs
  35. and a (little) copy-fee. In addition, no one is allowed to put these  files onto
  36. a PD-disk or an CD-Rom. You can get a permittion by the author. Please contact!
  37.  
  38. For the AmiNet, FreshFish and MeetingPearls CD-Rom's is no permittion requiered!
  39.  
  40.   This  program is Shareware. Everyone, who use this program, should register it
  41. by  sending me  the registration  fee (see below). The shareware  fee is  5,- DM
  42. plus postage. 
  43.  
  44.   When you use this little program, than you use it on your own risk! The author
  45. take no respons for damage made by AmigaEYE!
  46.  
  47. --------------------------------------------------------------------------------
  48.  
  49. What is it?
  50.   Do you know these funny Eye-programs, which follow the mouse-pointer! Ok. Than
  51. you know AmigaEYE. It's an Eye-program for an upstyled Workbench.
  52.   The first lines of code are written back in 1995 and were released as MagicEYE
  53. Since that first work are 2 years  gone by and so the program changed a lot (not
  54. only the Name and the shareware fee). Look at the history at the end ;-)
  55.  
  56. --------------------------------------------------------------------------------
  57.  
  58. 12 reasons, why to use this program:
  59.  
  60.  1.) colorized eyes ;^)
  61.  2.) Eye-sets with different sizes
  62.  3.) automatic window close, when WB is closed (screennotify.library)
  63.  4.) you can configurate a lot
  64.  5.) patch to have an screen-drag AmigaEYE-window
  65.  6.) 10(!) different eye-effects
  66.  7.) colorremapping, MagicWB nolonger needed (AmigaOS 3.0+)
  67.  8.) very short program
  68.  9.) it's an commodity
  69. 10.) can copy screen-background into AmigaEYE-window
  70. 11.) AmigaEYE-window is the hindmost window
  71. 12.) Eyes for different sizes
  72.  
  73. --------------------------------------------------------------------------------
  74.  
  75. What do you need?
  76.   You need  of course an  Amiga-Computer  (or an compatible  one ;^) ). Also you
  77. need  at least AmigaOS 2.04  or  higher. Sorry, but  I can't guarantee, that the
  78. version for  AmigaOS 2.04 work, because I  have only an  Amiga with AmigaOS 3.0.
  79. In  addition to the OS you  should run your Workbench with at least 8 colors and
  80. a quadratic resolution (e.g.  640×512).  Last  but  not least you should  use an
  81. 13 point  high font  for screen title.  This is necassery,  because AmigaEYE has
  82. an fixed high of  13 points.  And new for  release 2 of  AmigaEYE  you  need the
  83. screennotify-library from  Stefan Becker (optional, if you want automatic  close
  84. of the AmigaEYE-Window when WB close).
  85.  
  86. --------------------------------------------------------------------------------
  87.  
  88. Different program versions:
  89.   It's very simple:  The 'new' AmigaOS 3.0  has some  better functions which are
  90. supported by AmigaEYE. And so, I have produced two versions: One for AmigaOS 2.0
  91. (AmigaEYE_37) and one for AmigaOS 3.0 (AmigaEYE_39) and higher.
  92.  
  93. --------------------------------------------------------------------------------
  94.  
  95. How to install?
  96.   Nothing simpler than that: you copy only the right program-version of AmigaEYE
  97. to your  WBStartup-directory  on you startvolume  (disk, hd...) and the files in
  98. the AmigaEYE/#?  into ENV:AmigaEYE/#?. In  addition to that do an reboot. That's
  99. it :-]
  100.   When you  want  to  run  your  User-Startup,  than  copy  AmigaEYE  into  your
  101. C-Directory, the AmigaEYE/#? files  into ENV:AmigaEYE/#?  and run  AmigaEYE from
  102. User-Startup.
  103.  
  104. --------------------------------------------------------------------------------
  105.  
  106. How to use?
  107.   You can run this program from the Workbench (or the WBStartup directory) and
  108. from a Shell (User-Startup).
  109.  
  110.   DONOTWAIT       : This has nothing  to do with  AmigaEYE. It's only a flag for
  111.                     Workbench.
  112.   WIN_X           : Where  do you want to place  the AmigaEYE-window?  Here  you
  113.   WIN_Y             configurate  the x and y  position.  Default:  WIN_X=545 and
  114.                     WIN_Y=1
  115.                     ATTENTION: If  you use  an  titlefont smaller than 13 point,
  116.                     set the value of WIN_Y to 0.
  117.   PRIORITY        : Defines the task-priority.  This value should  be lower than
  118.                     0, so, other programs (which need the system-time) gets more
  119.                     system-time. The default value is 0 (program) or -5 (Icon).
  120.   MOVEABLE        : Window can be moved on the screen.
  121.   DRAGPATCH       : With  this (non system-friendly)  patch it  is possible,  to
  122.                     drag the  screen  with the  AmigaEYE-window.  So there is no
  123.                     different on  the screen-title,  when  you want to drag down
  124.                     the screen (funny). Default is off!
  125.   BACKGROUND      : Copy the background of the  position, where the Eyes appears
  126.                     into the AmigaEYE window (and so into the background).
  127.   QUICKQUIT       : Enable faster quitting of AmigaEYE (with right Mousebutton).
  128.   BACKDROP        : Enable the Layer  Patch,  that bring the  AmigaEYE window to
  129.                     the  hindmost  window  (every time!).  ATTENTION: with  this
  130.                     patch there will be the function BehindeLayer (-54) from the
  131.                     layer.library changed!
  132.   SLEEP_PERIOD    : This  flag define  the time (in sec)  that the program wait,
  133.                     till it close the Eyes, when the mouse isn't moved!
  134.                     Default: 5. (Try different values!)
  135.  
  136.   SIZE            : Define the size of the graphic-set that is used. For a title
  137.                     font with the size 13 you need to use the graphic-set 13
  138.                     (SIZE=13)! ATTENTION: At this time there are only set's for
  139.                     the sizes 5,13, 16 and 26!
  140.  
  141.   LIDCOLOR1       : With these ToolTypes you can change the color of the graphic
  142.   LIDCOLOR2         After the keyword you must give an hex-number:
  143.   BLOODCOLOR                                  RRGGBB
  144.   PUPILCOLOR1          RR - red (00 - FF)
  145.   PUPILCOLOR2          GG - green (00 - FF)
  146.   PUPILCOLOR3          BB - blue (00 - FF)
  147.   EYECOLOR1         
  148.   EYECOLOR2         So FFFFFF means the color white!
  149.   PUPILREDCOLOR1    ATTENTION: When  the new color-values  aren't used,  then it
  150.   PUPILREDCOLOR2               can  be, that  there  are no  free  colors on the
  151.   PUPILREDCOLOR3               screen.
  152.  
  153. And now the effect-configuration. Very  important to know: The values,  that you
  154. give here, are interpreted as a probability (1/value). The value must be greater
  155. than 1, an value of 0 means, that this effect isn't activ:
  156.  
  157.   SLEEPY            : This  value is  needed, to  define how often the  Eyes are
  158.                       closed. 
  159.   TIRED             : Define, how often the eye-lid's go down to the half.
  160.   ROLL_SYNCHRON     : When roll the Eye synchron (in same direction).
  161.   ROLL_ASYNCHRON    : When roll the Eye asynchron (in different direction).
  162.   LEFTRIGHT         : How often the Eye's look Left-Right.
  163.   UPDOWN            : How often the Eye's look Up-Down.
  164.   RANDOM_EYE        : Defines, when you get the trembling Eye's.
  165.   BLOODY            : When get the red Eye's?
  166.   CLEAR             : When should get the red Eye's get cleared?
  167.   LEFT_EYE          : Close left Eye. (depend on SLEEPY)
  168.   RIGHT_EYE         : Close right Eye. (depend on SLEEPY)
  169.   ANGRY             : Angry Eyes. (depend on SLEEPY)
  170.   ANXIOUS           : Anxious Eyes. (depend on SLEEPY)
  171.   INSULT            : Insult Eyes. (pupiles look in other direction)
  172.   STOP_TIRED        : When to stop the TIRED effect.
  173.   STOP_ANGRYANXIOUS : When to stop the angry and anxious eyes.
  174.   STOP_EFFEKT       : When to stop any effect.  If you put here an 0  the effect
  175.                       run endless.
  176.   PUPILNORMAL       : When should normal pupils appear.
  177.   PUPILBIG          : When should big pupils appear.
  178.   PUPILCROSS        : When should cross pupils appear.
  179.   PUPILAMIGA        : When should Amiga pupils appear.
  180.   PUPILHEART        : When should heart pupils appear.
  181.  
  182.   So, that's it.  You know now all the features  of AmigaEYE. Or...? You want to
  183. know, how to exit this mega mighty program? Is it true? Do you want to quit this
  184. program?  Ok. I see... You want  know  this (very stupied :-|) feature: There
  185. are two ways (argh... three ways):
  186. 1.) Run AmigaEYE again!
  187. 2.) Run Exchange, select AmigaEYE and quit it!
  188. 3.) (when QUICKQUIT) Activate AmigaEYE-Window and press right Mousebutton!
  189.  
  190. --------------------------------------------------------------------------------
  191.  
  192. What can be made better?
  193.   * More funny things with the Eyes
  194.   * Eye's with eyebrow's?
  195.   * It is possible, that there exists errors (undocumented features ;^) or bugs)
  196.     which we doesn't want!
  197.  
  198. --------------------------------------------------------------------------------
  199.  
  200. Problem...
  201.   ...are possible  with AmigaEYE. When  you start AmigaEYE  and nothing  apears,
  202. than it  is possible, that the  additional-data-files aren't installed correctly
  203. or  that the wrong  version  is installed.  To avoid  this, copy  AmigaEYE/#? to
  204. ENV:AmigaEYE/#?  and restart the  computer.  Copy only  files from that AmigaEYE
  205. Archive,  from that  you start  AmigaEYE-exe (It's  possible, that some parts of
  206. the additional-files are changed from time to time)!
  207.  
  208. --------------------------------------------------------------------------------
  209.  
  210. ATTENTION: AmigaEYE is distributed via ADSG! So  registrations should be send to
  211. ADSG (look at extra file). ADSG: http://www.amigaworld.com/adsg/
  212.  
  213. To register AmigaEYE (and bug-reports, new ideas) send a mail to:
  214.  
  215.                  sMail:           Christian Krapp
  216.                                   Hagenmähderstr. 9
  217.                                 D-86391 Stadtbergen
  218.                                   (GERMANY)
  219.                  eMail:           Christian.Krapp@Augsburg.BayNet.De
  220.  
  221.         Shareware fee :           5,- DM
  222.  
  223. --------------------------------------------------------------------------------
  224.  
  225. History:         (xx means 37 (AmigaOS 2.04) or 39 (AmigaOS 3.0+))
  226.         __       __
  227.         )\\     /((                                          __
  228.        /  \\   /  \\               __         ________      / \\     ________
  229.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  230.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  231.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  232.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  233.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  234.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  235. / // © 1995--1997 by \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  236. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  237.       sMail:                                               ________ ___ _____
  238.   Christian Krapp                 eMail:                  / __//\ \V /// __//
  239.   Hagenmähderstr.9    krabbe@informatik.fh-augsburg.de   / _//   \  /// _//
  240. D-86391 Stadtbergen                                     / //__   / /// //__
  241.   (GERMANY)                        WWW:                 \___//  /_// \___//
  242.  
  243. Vxx.0   28.04.1995 - First try (produced MagicEYE-Animation).
  244. Vxx.1   16.06.1995 - After a long work it's done. The first public-version ok.
  245. Vxx.2   01.08.1995 - Silly error removed (Thanks Roland Fulde).
  246.                    - Colorizing implemented  (Markus Speicher and Mario Cattaneo
  247.                      were interessted, only 39.x-Version).
  248.                    - ScreenNotify-Library supported (Mario Cattaneo).
  249.                    - Rolling Eye (Dirk Wrocklage).
  250.                    - Tremble and red Eye's (Michael Krapp).
  251.                    - Rolling  Eye  asynchron,  tired  Eye  and  look  Left-Right
  252.                      (Christian Krapp)
  253. Vxx.3   01.03.1996 - ScreenNotify-Library optional!
  254.                    - supports Commodity-Library 
  255.                    - red Eye's become white after a while of closed Eye's
  256.                    - removed  time-waste  when Eye's are  closed  (problems with
  257.                      Nemac IV)
  258. Vxx.4   20.02.1997 - Trancparent background (optional)!
  259.                    - Quickquit again included!
  260.                    - MagicEYE window is hindmost window
  261.                    - MagicEYE in WWW http://www.fh-augsburg.de/~krabbe/magiceye/
  262.                                              _   _
  263.                                             / \ / \
  264.                                             \#/ \#/
  265.            _              _                    _      _             _
  266.           /(\         :  /(\     _            /(\    /(\           /(\
  267.          /  \           /  \    /(\          /  \   /  \          /  \
  268.         /    \         /    \  /  \         /    \ /    \___     /    \
  269.        /      \       /      \/    \       /     //     ___ \   /      \
  270.       /        \     /              \     /     //     /\__\ \ /        \
  271.      /          \   /                \   /     //     / /   )//          \
  272.     /     /\     \ /     /\    /\     \ /     //     / /    \/     /\     \
  273.    /     /__\    //     / /\  / /\    //     //     / /______\    /__\     \
  274.   /     ____    //     / /  \/ / /   //     //     / / _     \\    ____     \
  275.  /     /\__/   //     / /    \/ /   //     / \    ( /\( \    /\\   \_  \     \
  276.  \    ( / (___/ \    ( /       (___/ \    ( / \    V  \\/   / / \___)\  )    /\
  277.   \    V   \__\/ \    V         \__\/ \    V   \    \__7   / /   \__\/ /    / /
  278.    \___/\         \___/\               \___/\   \_________/ /          \___/ /
  279.     \__\/  sMail:  \__\/     eMail:     \__\/    \________\/            \__\/
  280.                                                            _______  ___ _____
  281.   Christian Krapp     Christian.Krapp@Augsburg.BayNet.De  / __//\ \/ /// __//
  282.   Hagenmähderstr.9                                       / _//   \  /// _//
  283. D-86391 Stadtbergen                                     / //__   / /// //__
  284.   (GERMANY)                                             \___//  /_// \___//
  285.                                 © 1995,1996,1997,1998,1999 by Christian Krapp
  286.                                                   Freigegeben als SHAREWARE
  287.  
  288. Vxx.5  01.07.1997  - Bug in Layer-Patch removed
  289.                    - Needs less cpu-time!
  290.                    - You can change the color of the eyelid, bloody eyes, pupils
  291.                      and eyes.
  292.                    - New effects:
  293.                      + eyelid can close independent form other lid,
  294.                      + angry, anxious and insult eyes,
  295.                      + Pupil look up and down.
  296.                      + different pupil-graphics:
  297.                        * normal
  298.                        * big pupil
  299.                        * cross pupil
  300.                        * amiga pupil
  301.                        * heart pupll
  302.                    - Disable the single effects.
  303.                    - Window can be moved
  304.                    - Needed ToolTypes implemented.
  305.                    - Additional configuration-file.
  306.                    - Removed a lot of bugs.
  307.  
  308. Vxx.6   28.11.1998 - Eyesize is now variable
  309.                      + different Graphicsets: 5, 13 and 26 Points
  310.                      + Effects uses now different sizes
  311.                    - Optimiert  (internal  Graphicset  removed,  configurations-
  312.                      file load),
  313.                    - Bug in DRAGPATCH removed.
  314.                    - Uses ENV:AmigaEYE/ for all configuration-files.
  315.                    - New effect: left-right asynchron.
  316.                    - Removed some bugs
  317. Known problems:    - There is a problem with the BACKGROUND option on 16/24 Bit
  318.                      screens.
  319.  
  320. --------------------------------------------------------------------------------
  321.